home *** CD-ROM | disk | FTP | other *** search
/ Collection of Internet / Collection of Internet.iso / winprogs / wlprs40a / wsockaid.asc < prev    next >
Encoding:
Text File  |  1994-05-20  |  4.1 KB  |  98 lines
  1.                    WSOCKAID.DLL Version 2.0
  2.                                
  3.                         March 16, 1994
  4.                                
  5. This DLL contains functions that are currently missing in the
  6. Windows Sockets 1.1 specification, but which are needed for
  7. some networking applications. Currently this DLL supports only
  8. FTP Software's PC/TCP Version 2.1 and above. For this TCP/IP
  9. stack, all information that WSOCKAID.DLL can give is retrieved
  10. from the PCTCP.INI file (or whatever your PCTCP env. variable
  11. points to). If want to use this DLL together with other stacks
  12. and get errors like "Could not resolve username" from network
  13. applications, look at the list of functions below. For each
  14. inquiry function the information returned to a program can also
  15. be defined in the WIN.INI file by creating a section named
  16. [WSOCKAID] and adding the appropriate entry.
  17.  
  18. For setting the username a Control Panel Applet named
  19. WSAIDCNF.CPL is included. If you move this program to your
  20. WINDOWS/SYSTEM directory, you can set  the username by double-
  21. clicking on the "question mark face" icon. See also the remarks
  22. of the WSAIDGetUsername function below.
  23.  
  24. The following functions are exported by this DLL:
  25.  
  26. WSAIDGetUsername                    This function retrieves the
  27.                    user name that a PC user has registered
  28.                    with the networking software. If the used
  29.                    networking software has a real Windows
  30.                    network driver (like PC/TCP 2.2 has) and
  31.                    this driver supports the WNetGetUser
  32.                    function, the return value of this function
  33.                    is given to the calling program instead of
  34.                    the username defined in the [WSOCKAID]
  35.                    section of WIN.INI. You can override this
  36.                    behaviour to always use the username in the
  37.                    [WSOCKAID] section by putting an entry like
  38.  
  39.                              AlwaysUseWSAIDUsername=1
  40.  
  41.                            into this section, or checking the
  42.                    corresponding box in the Control Panel
  43.                    applet.
  44.                                     To find out if your
  45.                    networking software has such a driver, look
  46.                    if the [boot] section in SYSTEM.INI
  47.                    contains a network.drv= entry that is not
  48.                    empty.
  49.                    
  50.                    [WSOCKAID]-Entry:  User=<username>
  51.  
  52. WSAIDGetRealname                    This function returns the
  53.                    real name that a PC user has registered
  54.                    with the networking software.
  55.                    
  56.                    [WSOCKAID]-Entry:  Full-Name=<user's real
  57.                    name>
  58.  
  59. WSAIDGetHostname                    This function returns the
  60.                    locally defined host name for the PC
  61.                    (without any domain information appended).
  62.                    
  63.                    [WSOCKAID]-Entry:  Host-Name=<PC's
  64.                    hostname>
  65.  
  66. WSAIDGetDomain                      This function returns the
  67.                    Internet domain that the PC belongs to.
  68.                    
  69.                    [WSOCKAID]-Entry:  Domain=<PC's domain>
  70.  
  71. WSAIDGetDefaultPrinter              This function returns the
  72.                    default LPR network printer as separate
  73.                    queue and server name.
  74.                    
  75.                    [WSOCKAID]-Entry:  LPRQueue=<queue name>
  76.                                    LPRServer=<server name>
  77.  
  78.  
  79. Copyright:
  80.  
  81. This DLL is Copyright (C) 1993-94 by Thomas Heil.
  82. Redistribution of this DLL is allowed only together with the
  83. documentation (as MS Word for Windows 2.0 .DOC file and as
  84. plain ASCII .ASC file). This software may not be sold by
  85. itself. Applications that use this DLL may be sold together
  86. with the DLL and its documentation included royalty free.
  87.  
  88. If you are a network software vendor and think that your TCP/IP
  89. stack should be supported, please contact me.
  90.  
  91. Author:
  92.  
  93. Thomas Heil
  94. Hindenburgstr. 50
  95. 41352 Korschenbroich
  96. E-Mail: th.heil@kfa-juelich.de (Internet)
  97.  
  98.